QTHLOC ver 4.2 help-file don't change this file, the program use it !
                  É» ÍËÍ Ö_Ò ·  É» ÉÍ
                  ÈÊ  Ð  Ó Ð ÈÍ È¼ ÈÍ c   Ver 4.2
 This program will help you with the boring job to make contest-log.
 It will also help you to calculate distance and direction between
 to QTH:s. You can give input as QTH-locator or as longitude and
 latitude. The Program convert longitude and latitude to QTH-locator
 and the reverse is of course possible.

 This program may be copied and distributed under this conditions:
 A. No fee is charged for its distribution.
 B. It must be distributed without modification.
 C. It may not be distributed by commercial firms without permission.
 
 If you find this program of use, a contribution of $10 ( or 50 Swedish
 kronor) will be helpful to make new and better versions of this program
 and new programs.
        Author  : Curt Lundstedt, SM0GCW
        address : Orvar Odds vag 10  S-112 54 STOCKHOLM  SWEDEN

 A worldwide QTH-locator system designed for HAM-radio.

 The earth's surface is divided into 18*18=324 "FIELDS", 20 degrees
 longitude and 10 degrees latitude. Each field is divided into 10*10=
 100 "SQUARES", 2 degrees longitude and 1 degrees latitude. Finally each
 square is divided into 24*24=576 "SUBSQUARES", 5 minutes longitude 2.5
 minutes latitude. The fields are given by 2 letters AA - RR. The
 squares by 2 digits 00 - 99. The subsquares by 2 letters AA - XX. The
 first character gives the longitude and the second character gives the
 latitude on each level. A complete locator is 6 character long.

 Example  59 degrees North, 18 degrees East, give locator JO99AA

 Reference literature: The Radio Amateur's World Atlas  by SM5AGM
                       SSA, Ostmaksgatan 43  S-123 42 FARSTA SWEDEN

 More about using the locator is found under help for the commands.


 Help to calculate direction and distance from QTH-locator

 Give the QTH-locator of the starting point and the point you will cal-
 culate. The program calculate and give you answer.

 Example 1  JO99AH to KO03DX give 608 km and 166 degrees.

 Example 2  DM14LK to GG66MA give 9834 km and 121 degrees.

 Help to calculate direction and distance from longitude and latitude

 Give your longitude and latitude of the starting point and the point
 will calculate. The program calculate and give you answer.
 Western longitude and southern latitude should be entered as negative
 values.
 
 Example 1   18 degrees East, 59 degrees 18 minutes North to
             20 degrees 15 minutes East, 53 degrees 58 minutes North
             give 607.7 km and 166 degrees 

 Example 2   117 degrees 5 minutes Vest, 34 degrees 25 minutes North
             47 degrees vest, 24 degrees South 
             ( you write  -117 -5 0 , 34 25 0  and  -47 0 0 , -24 0 0 ) 
             give 9836.9 km and 121 degrees

 Help for contest-log making

 Before you start enter the qso-data for the contest, the configuration
 data must bee entered. This data is only entered the first time when
 you use this program or when your equipment is changed.
 You have 5 different commands to use when you calculate your contest-
 log. In the free-format command can you order very different types of
 score calculation. The other 4 commands is predefined for your favorite
 contests. Read more about how to do predefined command in 'help-menu'.
 When you have made your choice, the qso-entering can be started.

 You simply answer the questions. If you make anything wrong, use the
 up-, down-arrow or the rubout or insert command. With the arrow-keys
 you also can step to next qso before or after.      
 When you have entered all qso press Esc or ctrl-c to continue to next
 step. If you have a file of qso already stored on disk the program
 ask if you want to delete it. Don't be afraid, if you say Y the
 program store the old qso-data under the name QTHREC.BAK (backup).

 Help for contest-log making

 Answer the questions on screen. Then press enter, escape or ctrl-c.

 The first question ask for one or more letter, A-I. 

 Example 1  C   Give you one point per 10 km distance ( km is rounded
                                             up to next km )
 Example 2  F   Give you one point per worked square.

 Example 3  AE  Give you one point per km multiply with one point per
                Call-prefix.
 Example 4  AI  Give you one point per km multiply with number of GHz,
                a qso on 2304 GHz and 65 km give 2 * 65 = 130 points.

 Determination of QTH-locator

 You enter your longitude and latitude. Western longitude and southern
 latitude should be entered as negative values.

 Example 1  18 degrees 2 minutes East longitude and 59 degrees 18
            minutes 40 seconds North latitude should be entered as
            18 2 0 and 59 18 40. The result will be  JO99AH

 Example 2  117 degrees 5 minutes West and 34 degrees 25 minutes North
            should be entered as -117 -5 0 and 34 25 0.
            The result will be DM14KK

 Convert QTH-locator to longitude and latitude

 You enter the QTH-locator. The program will calculate and give you
 longitude and latitude. Western longitude and southern latitude is
 given as negative values.

 Example   DM14LK  The result will be -117,-5 degrees longitude and
                   34,25 degrees latitude.
                   (117 degrees 5 minutes West and 34 degrees 25
                    minutes North)
                  

 How to make commands for your favorite contest.
 You make a file with your ordinary editor. The file must be named
 QTHLOC.DCL . The file shall contain 4 lines. 1 HF, 2 VHF, 3 UHF,
 4 SHF. Each line shall have one or more letter just like 'free-
 format' command. After the letter you can add a bonus factor. 
  A  one point per Km distance.
  B  one point per Km distance ( if>2000km=2000 points ).
  C  one point per 10 Km distance.
  D  multiply factor * point per square.
  E  multiply factor * point per Call-prefix ( two first characters).
  F  add factor * point per square to the total sum.
  G  add factor * point per Call-prefix to the total sum.
  H  multiply with every 100 MHz ( 144 give 1 point, 432 give 4 ...)
  I  multiply with every GHz ( 2304 give 2 point, 10368 give 10 ...)
 Example                                                       file
  HF one point per km mult. one point per call-pref.          AE
  VHF one point per km and 400 points per square.             AF 400
  UHF one point per km with limits.                           B
  UHF one point per km mult. with number of GHz for etch qso  AI

 Files QTHLOC produce or use

 QTHLOC.EXE     The QTHLOC program started under MS-dos
 QTHLOC.CNF     Contain your personal data. Station, antenna ...
 QTHLOC.DCL     Define commands for your favorite contest
 QTHLOC.HLP     Contain help text, and message. This file.
 QTHREC.REC     Records of QSO data
 QTHREC.BAK     Backup of latest deleted QSO data, you can rename the
                file and use it again if you need.
 xdate.PRI      Contest-log ready to print on your lineprinter
 xdate.BAK      Backup of contest-log
                ( x = type of test, H HF, V VHF, U UHF, S SHF )
 xdate.PAC      7 bit ASCII converted file for Packet radio 

 Personal setup data

 Enter data about yourself and your station.
 Enter also number of line on your line-printer ( paper length) and
 the color on screen. This data is stored on disk and you need only
 to work with it when something is changed. If you have problem with
 your screen or if you want to change color this color is valid.

 0 : Black, 1 : Blue, 2 : Green, 3 : Cyan, 4 : Red, 5 : Magnenta
 6 : Brown, 7 : Gray, 8 : Lightgray, 9 : LightBlue, 10 : LightGreen
 11 : Lightcyan, 12 : Lightred, 13 : Lightmagenta, 14 : Yellow,
 15 : White.
 If you have black and white screen try with color text = 15,
 color background = 0 and color field = 0.

 Printer function

 This function use normal LPT1 output. You can use a editor to
 change the log-file. If you have a unusual printer use your own
 print-program direct to xdate.PRI file ! You can also send this
 file to your testmanager via packet radio.
 The first letter in file name depend on type of test:
 V = VHF  U = UHF  S = SHF  H = HF
 The rest of the name is date for the test.

 Packet radio conversion function

 This function is useful in northern countries using special letter
 '†„” Ž™ ...'. This letter must be converted to 7 bit ASCII
 before you can send it via packet radio.

    
SM0GCW c 1991 please don't change this file ! The QTHLOC program use it !

